home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / mus / play / AmigaAMP.lha / AmigaAMP / AmigaAMP.readme < prev    next >
Text File  |  1999-01-21  |  18KB  |  470 lines
  1. Short:    MPEG audio player with GUI (68k/PPC)
  2. Uploader: Thomas Wenzel (wenzel@unixserv.rz.fh-hannover.de)
  3. Author:   Thomas Wenzel (wenzel@unixserv.rz.fh-hannover.de)
  4. Type:     mus/play
  5. Version:  2.4
  6.  
  7. Homepage
  8. --------
  9. http://amigaamp.amiga-software.com
  10.  
  11.  
  12. Introduction
  13. ------------
  14. AmigaAMP is a GUI based MPEG audio player using mpega.library on the 68k
  15. processor or the amp decoding engine in the PPC version.  Sound is played
  16. back using the AHI audio system.  AmigaAMP is NOT another frontend for the
  17. CLI based mpega.  Anyway, if you've got problems not related to the user
  18. interface but with AHI, AsyncIO or mpega.library, PLEASE contact the
  19. corresponding author directly.  I wouldn't be able to help you in this
  20. case.
  21.  
  22. Important: AmigaAMP is optimized for visual appearance and accuracy, not
  23. for speed!
  24.  
  25. Requirements (not included in this archive!)
  26. --------------------------------------------
  27. AmigaOS 3.0 or higher
  28. 68030-50MHz processor or better
  29. mpega.library    (Aminet:util/libs/mpega_library.lha)
  30. asyncio.library  (Aminet:dev/c/AsyncIO.lha)
  31. AHI audio system (Aminet:mus/misc/ahiusr.lha)
  32.  
  33.  
  34. Recommended
  35. -----------
  36. PowerUP and ppc.library v46
  37. AmigaOS 3.1 (OS3.1 is needed for the internal spectrum analyzer!)
  38.  
  39. Features
  40. --------
  41.  - FREEWARE!  No beta, no nag requesters and no expiry date!
  42.  - GadTools based font sensitive user interface
  43.  - Alternatively WinAMP compatible user interface
  44.  - Fast, synchronous spectrum analyzer (almost no latency)
  45.  - Workbench application (you can drop icons on its window)
  46.  - Easily configurable
  47.  - AHI device-level access (uses default audio mode automatically)
  48.  - ID3 tag editor (artist, title, albm, etc.)
  49.  - Visualisation plugin system
  50.  
  51.  - support for
  52.  
  53.    * hardware based decoders
  54.      -----------------------
  55.      - MPEGit (addon MPEG audio decoder module for Prelude soundcard)
  56.  
  57.    * software based decoders
  58.      -----------------------
  59.      - internal PowerUP decoging engine (amp 0.7.6)
  60.      - mpega.library (either PowerUP, WarpUP or 680x0 based)
  61.  
  62.  
  63. Limitations
  64. -----------
  65.  - The PPC version doesn't support MPEG2.5 yet, I'm working on it
  66.  - No realtime spectrum when using AmigaOS 3.0 -- sorry guys!
  67.  - No realtime spectrum when playing MP2 files yet
  68.  
  69. History
  70. -------
  71. v2.4  - Due to lack of time it may take a while until I can answer your
  72.         email. Perhaps I won't be able to answer it at all :-(
  73.         Please be assured that I _read_ each and every mail. I'm always
  74.         happy to receive feedback :)
  75.       - visualisation plugins didn't receive data when AmigaAMP was run
  76.         in GadTools mode -- fixed that
  77.       - yet another bug in the ID3 loader/saver detected and eliminated
  78.       - new fullscreen plugin added to the distribution archive
  79.  
  80. v2.3  - reworked the skin display once again
  81.       - 68k based spectrum analyzer that works with mpega.library, too
  82.         (68060 processor and/or PPC version of mpega needed)
  83.       - visualisation plugin system (only makes sense when using the
  84.         internal PPC decoder)
  85.       - fixed a bug that caused some MP3s to be treated as playlists
  86.       - activated shuffle gadget now shuffles the playlist each time
  87.         you start playing the first track
  88.       - included an 060 optimized version
  89.  
  90. v2.2  - better CyberGraphX compatibility
  91.       - editable playlist including loading and saving (from the menu)
  92.       - time/remain display
  93.       - freaky animation in the bottom right corner :)
  94.       - autoscrolling song/artist text in WinAMP mode
  95.       - skin display while loading on highcolor/truecolor screens
  96.       - random play (shuffle)
  97.       - more alphabetically sorted genres
  98.       - key sensitive genre requester
  99.       - pitch shift (+ and - keys on numeric keypad, * resets speed)
  100.       - improved PUBSCREEN and SCREENMODE capabilities
  101.       - fixed internal crossfader
  102.         Start two aamps and hold shift while dragging the volume slider
  103.       - support for 'nums_ex' and 'volbar' named skin images
  104.  
  105. v2.1  - configurable playback buffer size (should cure many problems!)
  106.       - fixed a bug that caused truecolor skins to be dithered even on
  107.         truecolor screens
  108.       - Skin pictures can have any extension you like as long as the name
  109.         is correct.
  110.       - Fixed a bug in the PPC loader for 48 kHz MPEGs
  111.       - asynchronous filerequester
  112.       - Skins can be reloaded at any time.
  113.       - auto-play after opening a file if playback was active before opening
  114.       - corrected some skin positions
  115.       - visualisation for the 68k version, too (level meters)
  116.       - MaxFreq finally works
  117.  
  118. v2.0  - so many changes it was worth bumping the version number :-)
  119.       - position of genre listview gadget fixed
  120.       - fixed bugs when playing mono or 22.05 kHz files
  121.       - digital volume control
  122.       - AREXX interface (see AREXX.readme)
  123.       - automatic detection if another AmigaAMP task is already
  124.         running
  125.       - alphabetically sorted playlist (not editable yet)
  126.       - configurable buffersize
  127.       - WinAMP lookalike GUI (see below)
  128.       - Improved fontsensitivity of old GUI
  129.       - cached taginfo -- will be written when the file is closed
  130.  
  131. v1.1  - name changed to AmigaAMP
  132.       - PPC version
  133.       - ID3 tag editor
  134.       - commandline support
  135.  
  136. v1.0  - initial release called MPEGAHI
  137.  
  138. Getting started (configuration)
  139. -------------------------------
  140. Important! You need a properly installed and configured AHI audio system
  141. to run AmigaAMP. Without a correct setup the sound may be very poor and
  142. AHI will draw too much CPU power!
  143.  
  144. First of all run the AHI setup program in your Prefs drawer. Select
  145. one of the units from 0 to 3 but not the Music unit. If you don't use
  146. unit 0 for anything already I recommend using that one.
  147.  
  148. Select one of the "fast stereo++" audiomodes that matches your audio
  149. hardware. For Prelude playback I recommend "Prelude:Fast 16 bit stereo++
  150. realtime".
  151.  
  152. Now you need to know what sampling rate most of your MPEG files
  153. have. Probably it's 44100 Hz because that's the standard CD rate. If
  154. you have a slow processor you may want to run AmigaAMP in frequency division
  155. mode to reduce CPU load. Have a look at the table below for the recommended
  156. settings.
  157.  
  158. It is important to set the frequency slider to your mostly used frequency
  159. divided by your chosen frequency divisor. For example, if you're going to
  160. playback lots of 44100 Hz MPEGs and frequency division is 1:2, set the
  161. Frequency slider to 22050 Hz.
  162.  
  163. If you don't plan to have several programs playing back audio at the
  164. same time, please leave the Channels slider at position 1. The remaining
  165. settings depend on your audio hardware.
  166.  
  167. Ok, press the "Save" button in the bottom left corner.
  168.  
  169. Now it's time to configure AmigaAMP itself. If you've chosen another
  170. AHI device than 0, you have to change the AHIUNIT tooltype of AmigaAMP
  171. first. If not, just start it by double clicking on its icon and pop up
  172. the setup window by chosing Config... from the menu.
  173.  
  174. Set the sliders and checkmarks to the recommended settings, save them using
  175. the menu and close the settings window again.
  176.  
  177. That's it! AmigaAMP is now configured. You may want to fine-tune the
  178. settings later. The overall performance depends on the speed of mpega.library
  179. AND the the speed of your soundcard's AHI driver.
  180.  
  181. Recommended settings (tested with Prelude:Fast 16 bit stereo++ realtime)
  182. ------------------------------------------------------------------------
  183.  
  184.           |     Layer 1/2        |        Layer 3
  185. Processor | Quality|FreqDiv|Mono | Quality|FreqDiv|Mono
  186. ----------+--------+-------+-----+--------+-------+-----
  187. 68040-40  |  high  |  1:2  | off | medium |  1:2  | on 
  188. 68060-50  |  high  |  1:1  | off |  high  |  1:1  | off
  189. PPC604e   |  high  |  1:1  | off |  high  |  1:1  | off
  190.  
  191. Note: In fact only the 68k version is affected by these settings.
  192.  
  193.  
  194. Advanced settings
  195. -----------------
  196. * Bufsize:
  197. Set the size of the read ahead buffer. Try playing with it until you
  198. get best results. (Normally 16 to 32K is best)
  199. Setting the buffersize to FILE means that the read ahead buffer will
  200. be as large as the current track eliminating all disk access during
  201. play. Attention! This option isn't 100% stable yet!
  202.  
  203. * TaskPri:
  204. Set the running task priority of AmigaAMP. The recommended value for
  205. uninterrupted playback is 1. God knows what happens if some 3rd party
  206. task rescheduler starts fiddling around with AmigaAMP's internal task
  207. priorities...
  208.  
  209. * Read ID3 TagInfo
  210. Try to read information about artist, title, etc. Because those are stored
  211. at the end of the file it may slow down loading a bit. If this function
  212. is switched off, TagInfo can neither be edited nor saved!
  213.  
  214. * Allow multiple instances
  215. Normally when you click on an MPEG file project icon while AmigaAMP is
  216. already playing another one, no second AmigaAMP task will be launched but
  217. the already running task will start playing the new file. This behaviour
  218. can be switched off. You have to start AmigaAMP twice manually and then
  219. save the config with "Allow multiple instances" switched on from both
  220. running tasks.
  221.  
  222. * Limit volume to 0dB
  223. The volume slider ranges from silence to +6dB volume so that you can boost
  224. more silent recordings. If you don't want to turn the volume above normal
  225. accidentally, you can switch on this option.
  226.  
  227. * ToolType: MPEGIT
  228. Use MPEGit hardware decoder
  229.  
  230. * ToolType: DIRECTORY
  231. Default directory to display in filerequester.
  232.  
  233. * ToolType/Keyword: SCREENMODE
  234. Tell AmigaAMP to use its own screen. The mode has to be specified in
  235. decimal or hexadecimal format. Hex values have to be preceeded by
  236. <0x> or <$>. Example: SCREENMODE=0x50021303
  237.  
  238. * ToolType/Keyword: PUBSCREEN
  239. Name of the public screen that AmigaAMP will display its GUI on.
  240. Example: PUBSCREEN=DOPUS.1
  241.  
  242. Usage (how to load and play sounds)
  243. -----------------------------------
  244. Most of the buttons should be self-explanatory because they can be found
  245. on almost every CD player or tapedeck. However, as a computer program,
  246. AmigaAMP is based on files, so there may be slight differences. The bottom
  247. line buttons from left to right are:
  248.  
  249.  - Eject      Stops playback, empties the current playlist and opens a
  250.               requester to select one or more files
  251.  - Skip back  Moves to the previous track in the playlist if there is one.
  252.  - Stop       Simply stops playback. (What else did you expect? :-)
  253.  - Play       Starts playback if there's at least one track in the current
  254.               playlist. If it's not, opens a requester to select tracks.
  255.  - Skip fwd   Moves to the next track in the playlist if there is one.
  256.  - Pause      Pauses playback at the current position
  257.  
  258. Just above the control button's there's a position slider. As you play
  259. a file, it's button moves from left to right to display the relative
  260. playback position within the current track. You can use the mouse to drag
  261. this slider to a new position.
  262.  
  263. Keyboard shortcuts
  264. ------------------
  265. CURSOR RIGHT        skip 10s forward
  266. CURSOR LEFT         skip 10s backward
  267. CURSOR UP           increase volume
  268. CURSOR DOWN         decrease volume
  269. SPACE               play/stop
  270. P                   pause
  271. NUM +               increase speed by one semitone
  272. NUM -               decrease speed by one semitone
  273. NUM *               normal playback speed
  274. Z                   skip back one track
  275. X                   play
  276. C                   pause
  277. V                   stop
  278. B                   skip fwd one track
  279. N                   eject
  280.  
  281. About the WinAMP GUI
  282. --------------------
  283. Since WinAMP v1.80 you can load customizeable textures (so called skins) for
  284. the GUI. The skins consist of several bitmapped pictures together in one
  285. directory and contain the the look of the window itself as well as images
  286. for all the gadgets. Because more and more people ask me to make AmigaAMP
  287. look like WinAMP I now included an alternative GUI routine that can load
  288. those WinAMP skins!
  289.  
  290. To keep the archive small I'm just including the base skin from now on.
  291.  
  292. To activate one of those GUIs you have to start AmigaAMP with the options
  293. NewGUI and Skin=<subdirectory name>. If you just want the WinAMP like basic
  294. look you can simply type "AmigaAMP NG" where NG is the shortcut for NewGUI.
  295. For the other designs a highcolor display mode on a graphics card
  296. is strongly recommended.
  297.  
  298. Although the pictures all have the extension .iff they can be any format
  299. that you have a datatype for. If you find a working BMP datatype (try
  300. loading the pictures with multiview first) you can even copy WinAMP skins
  301. direcly. AmigaAMP will try to load pictures with different extensions
  302. automatically.
  303.  
  304. At the moment not everything of the WinAMP GUI is really functional. For
  305. example there's no spectrum analyzer for MP2 and no graphic EQ. Anyway,
  306. most of the rest is working!
  307.  
  308.  
  309. Legal stuff
  310. -----------
  311. AmigaAMP is copyrighted freeware. It may be distributed freely as long as
  312. no modifications are made to the executable and this document. A nominal
  313. fee may be asked to cover distribution costs.
  314.  
  315. AmigaAMP may not be used for any commercial purposes or included with any
  316. commercial product without the written permission of the author. It may not
  317. be advertised, offered or distributed together or in conjunction with
  318. commercial products. The only exception is the Aminet archive.
  319.  
  320. AmigaAMP makes use of the MPEG Layer-3 audio compression technology licensed
  321. by Fraunhofer IIS and THOMSON multimedia.
  322.  
  323. No responsibilities are taken for damaged speakers, amplifiers, Amigas
  324. or any other components or data involved while using AmigaAMP.
  325.  
  326. Although I've done some beta testing I can't guarantee that AmigaAMP will
  327. not crash! If you find any bugs, let me know.
  328.  
  329. Here's the original amp.readme:
  330. -------------------------------
  331. amp MPEG audio decoder readme file (version 0.7.5)
  332. (C) Tomislav Uzelac  1996,1997
  333.  
  334. amp is free software and can be _used_ freely by anyone. If you want to
  335. do anything else with it, be sure to check the Legal section of this
  336. document for legal issues.
  337.  
  338. THERE IS NO WARRANTY FOR THIS PROGRAM. Please check out the Legal section
  339. of this document.
  340.  
  341. 1. Introduction
  342. 2. Installation
  343. 3. Running
  344. 4. Feedback
  345. 5. Contributing
  346. 6. Legal
  347.  
  348.  
  349. 1. Introduction
  350.  
  351. amp (Audio Mpeg Player) is an MPEG audio decoder which I originally started 
  352. putting together as a side project of the MPEG hardware design project at 
  353. FER/Zagreb - just to confirm my knowledge of the standard. It works with
  354. both MPEG1 and MPEG2 audio streams (except for the multichannel extensions
  355. defined in MPEG2), layers 2 and 3. 
  356.  
  357. There is a gui for amp, written in Tcl/Tk by Edouard Lafargue. It is 
  358. available at the amp home site ftp://ftp.rasip.fer.hr
  359.  
  360. Another gui supported is the Sajber Jukebox, written by Joel Lindholm.
  361.  
  362. The following people contributed their time and knowledge to amp:
  363. Karl Anders Oygard, Ilkka Karvinen, Lutz Vieweg, Dan Nelson,
  364. Edouard Lafargue, Andrew Richards, George Colouris,
  365. Dmitry Boldyrev, Andy Lo A Foe, Thomas Sailer, Justin Frankel
  366.  
  367. amp home location is
  368.     ftp://ftp.rasip.fer.hr/pub/mpeg/
  369.  
  370. and the mailing list: send 'HELP' in the body of the message to:
  371.     multimedia@rasip.fer.hr
  372.  
  373. If you want to find out more about MPEG, best places to start are
  374.     http://www.mpeg.org
  375.     http://www.mpeg2.de 
  376.  
  377.  
  378. 2. Installation
  379.  
  380. Installation should be simple enough if amp was ported to your system,
  381. just do a 
  382.  
  383. ./configure
  384. make 
  385.  
  386. You can edit the makefile further to suit your system. If configure fails 
  387. to make a usable Makefile, you'll _have_ to edit it yourself.
  388.  
  389. Linux users should try real-time playing support, as described
  390. in doc/realtime.txt. Some people that might pass on this feature are
  391. those with slower machines (i.e. 486's), or SMP systems (see the
  392. doc/linuxrealtime.txt file). 
  393. Some versions of the linux C library produce an error when compiling
  394. amp with realtime support. A quick fix is to edit /usr/include/sched.h
  395. and replace _P in the offending line with __P.
  396.  
  397. ./configure --enable-realtime
  398. make
  399. chown root.root amp
  400. chmod u+s amp
  401.  
  402. ... this requires /dev/dsp to be both world readable and writeable. If you
  403. have a special group for people allowed to use the sound device (for
  404. instance, a group called sound), you can do a:
  405.  
  406. chmod g+s amp
  407.  
  408. or make your audio card world read/writeable (not recomended)
  409.  
  410. chmod o+rw /dev/dsp*
  411.  
  412. 3. Running:
  413.  
  414. 'amp -h' gives you usage & options. If your computer is on the slower
  415. side, direct playback might not work, but you can decode it
  416. to .wav or raw pcm and play it later.
  417.  
  418.  
  419. 4. Feedback
  420.  
  421. Send in your makefiles, opinions, bugreports, fixes; anything related to this
  422. program. You can also send me unlimited amounts of money, sugar, milk, etc.
  423.  
  424. If you find any mpeg audio files that amp has trouble decoding, please tell
  425. me about this via e-mail <tuzelac@rasip.fer.hr>.
  426.  
  427.  
  428. 5. Contributing
  429.  
  430. Please contribute to amp. If you want to know what is going on in amp 
  431. development, you can join the developers mailing list
  432.  
  433.     mpeg_audio_developers@rasip.fer.hr
  434.  
  435. There are certain debugging facilities that I made in amp, but are disabled
  436. in the current release (they are neither nice nor user-friendly). If anyone
  437. enhances them (they are in dump.c) to the point that they're actually
  438. usable I'll be happy to include the changes in the release. I think this
  439. kind of debug output would be very useful to people studying these audio
  440. algorithms.
  441.  
  442.  
  443. 6. Legal
  444.  
  445. This software can be used freely for any purpose. It can be distributed
  446. freely, as long as it is not sold commercially without permission from
  447. Tomislav Uzelac <tuzelac@rasip.fer.hr>. However, including this software
  448. on CD_ROMs containing other free software is explicitly permitted even 
  449. when a modest distribution fee is charged for the CD, as long as this
  450. software is not a primary selling argument for the CD.
  451.  
  452. Building derived versions of this software is permitted, as long as they
  453. are not sold commercially without permission from Tomislav Uzelac 
  454. <tuzelac@rasip.fer.hr>. Any derived versions must be clearly marked as
  455. such, and must be called by a name other than amp. Any derived versions
  456. must retain this copyright notice.
  457.  
  458. /* This license is itself copied from Tatu Ylonen's ssh package. It does 
  459.  * not mention being copyrighted itself :)
  460.  */
  461.  
  462. THERE IS NO WARRANTY FOR THIS PROGRAM - whatsoever. You use it entirely
  463. at your risk, and neither Tomislav Uzelac, nor FER will be liable for
  464. any damages that might occur to your computer, software, etc. in
  465. consequence of you using this freeware program.
  466.  
  467.  
  468. Tomislav Uzelac
  469. <tuzelac@rasip.fer.hr>
  470.